多通貨クレジットカード決済(DCC) インタフェース
概要
リンクタイプ Plus決済では、決済手段として多通貨クレジットカード決済(DCC)を利用することが可能です。多通貨クレジットカード決済(DCC)を利用するには、実行パラメータセットに多通貨クレジットカード決済(DCC)に必要なパラメータを渡す必要があります。
実行パラメータセットで会員IDを指定すると、会員IDに登録されているカード番号を表示、決済することができます。
リンクタイプ Plus決済で多通貨クレジットカード決済(DCC)が完了すると、遷移先URLに多通貨クレジットカード決済(DCC)の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
多通貨クレジットカード決済(DCC)固有の実行パラメータは以下の通りです。
json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
---|---|---|---|---|---|
リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
dcc |
多通貨クレジットカード決済(DCC)固有実行パラメータ多通貨クレジットカード決済(DCC)の実行パラメータセットです。 |
〇 | 〇 | ||
ItemCode | 半角数字7桁 固定
商品コード通常は省略してください。 |
〇 | 〇 | 0000990 | |
TdFlag | 半角数字1桁 固定
本人認証サービス利用フラグ本人認証サービスを使用して決済を行うかを指定します。以下のいずれかを設定します。 0:【利用しない】 3Dセキュア認証せず、決済をします。 1:【3DS1.0を利用する】 3DS1.0認証サポート終了のため、指定しないでください。 ・指定した場合、E21040002(3DS1.0閉塞後利用エラー)を返却します。 2:【契約に従う】 3Dセキュア(本人認証)のご契約に従います。 ・ご契約されている場合には3Dセキュア1.0、または3Dセキュア2.0認証実施のうえ、決済をします。 ・ご契約されていない場合には3Dセキュア認証せず、決済をします。 3:【3DS2.0を利用する】 3Dセキュア2.0認証実施のうえ、決済をします(ご契約されていない場合には、エラーとなります)。 |
〇 | 〇 | 2 | |
TdTenantName | 半角英数記号25桁
3Dセキュア表示店舗名3DS画面に表示する店舗名を指定します。EUC-JPでBASE64エンコーディングした値を指定します(日本語も使用可能ですが、文字化けが起こりやすいので使用する場合は十分な検証を実施してください。)。 省略時は店舗名が「未指定」となります。 |
〇 | 〇 | (null) | |
MemberID | 半角英数記号60桁
会員ID指定すると、登録済みカード番号を用いた決済が可能です。 |
〇 | - | (null) | |
SecCodeRequiredFlag | 半角数字1桁 固定
セキュリティコード必須フラグONにすると、セキュリティコードの入力が必須になります。0:OFF(任意入力) 1:ON(必須入力) |
〇 | 〇 | 0 | |
SecCodeHiddenFlag | 半角数字1桁 固定
セキュリティコード非表示フラグONにすると、セキュリティコード入力欄が非表示になります。0:OFF(表示する) 1:ON(表示しない) |
〇 | 〇 | 0 | |
Tds2Type | 半角数字1桁
3DS2.0未対応時取り扱い3DS2.0未対応カード時の後続処理について指定します。1:3DS1.0での認証を実施 2:エラーとして処理終了 3:通常オーソリを実施 3DS1.0認証サポート終了のため、1以外を指定してください。 |
〇 | 〇 | 1 | |
RegistMemberID | 半角英数記号60桁
決済後カード登録時会員ID決済後カード登録を行う場合の、カードを登録する会員IDを指定します。本パラメータを指定し、かつお客様がクレジットカード情報の登録を許可した場合、 決済成功後、指定した会員IDにクレジットカード情報が登録されます。 会員が存在しない会員IDを指定した場合、会員登録も行われます。 |
〇 | - | (null) | |
CardInputHiddenFlag | 半角数字1桁
カード番号入力欄非表示フラグONにすると、会員IDにカード番号が登録されている場合、カード番号入力欄を非表示とし、会員IDに登録済みのカードのみ選択可能となります。0:OFF(表示する) 1:ON(表示しない) |
〇 | 〇 | 0 | |
CardMaxCnt | 半角数字1桁
最大カード登録枚数決済後カード登録でカード登録をする場合、1会員で登録可能な最大カード枚数を指定することができます。指定可能な値は1~5までになります。 決済後カード登録時会員IDを指定した場合のみ、本パラメータが使用されます。 ※カード編集機能と決済後カード登録機能を併用しており、両機能で最大カード登録枚数を制御したい場合、カード編集機能と決済後カード登録機能の両方で設定が必要となります。 |
〇 | 〇 | (null) |
実行パラメータ仕様(3DS2.0)
3DS2.0専用のパラメータは以下の通りです。決済URL取得API実行時のみ、指定可能です。
json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
---|---|---|---|---|---|
リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
Tds2ChAccChange | 半角数字8桁 固定
カード会員最終更新日カード会員情報の最終更新日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
Tds2ChAccDate | 半角数字8桁 固定
カード会員作成日カード会員の作成日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
Tds2ChAccPwChange | 半角数字8桁 固定
カード会員パスワード変更日カード会員のパスワード変更日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
Tds2NbPurchaseAccount | 半角数字4桁
過去6ヶ月間の購入回数過去6ヶ月間に、このカード会員が購入した回数を設定します。 |
〇 | - | (null) | |
Tds2PaymentAccAge | 半角数字8桁 固定
カード登録日カード会員にカード情報が登録された日付を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
Tds2ProvisionAttemptsDay | 半角数字3桁
過去24時間のカード追加の試行回数過去24時間に行われたカード情報追加の試行回数を設定します。 |
〇 | - | (null) | |
Tds2ShipAddressUsage | 半角数字8桁 固定
配送先住所の初回使用日取引で使用される配送先住所が加盟店様で最初に使用された日付を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
Tds2ShipNameInd |
カード会員名と配送先名の一致/不一致カード会員の会員名と取引に使用される配送先名の一致/不一致を設定します。01:カード会員名と配送先名が一致 02:カード会員名と配送先名が不一致 |
〇 | - | (null) | |
Tds2SuspiciousAccActivity |
カード会員の不審行為情報カード会員で、不審な行動(過去の不正行為を含む)を加盟店様が発見したかどうかを設定します。01:不審な行動は見られなかった 02:不審な行動が見られた |
〇 | - | (null) | |
Tds2TxnActivityDay | 半角数字3桁
過去24時間の取引回数過去24時間に行われた、カード会員と加盟店様との取引の回数を設定します。 |
〇 | - | (null) | |
Tds2TxnActivityYear | 半角数字3桁
前年の取引回数前年に行われた、カード会員と加盟店様との取引の回数を設定します。 |
〇 | - | (null) | |
Tds2DeliveryEmailAddress | 半角英数記号254桁
納品先電子メールアドレス電子デリバリーの場合、商品を納品したときの納品先電子メールアドレスを設定します。 |
〇 | - | (null) | |
Tds2DeliveryTimeframe |
商品納品時間枠商品納品時間枠を設定します。01:電子デリバリー 02:当日出荷 03:翌日出荷 04:2日目以降の出荷 |
〇 | - | (null) | |
Tds2GiftCardAmount | 半角数字15桁
プリペイドカードまたはギフトカードの総購入金額プリペイドカードまたはギフトカードを購入の場合、総購入金額の小数点以上の値を設定します。 |
〇 | - | (null) | |
Tds2GiftCardCount | 半角数字2桁
購入されたプリペイドカードまたはギフトカードの総数プリペイドカードまたはギフトカードを購入の場合、購入された総数を設定します。 |
〇 | - | (null) | |
Tds2GiftCardCurr | 半角数字3桁 固定
購入されたプリペイドカードまたはギフトカードの通貨コードプリペイドカードまたはギフトカードを購入の場合、カードの通貨を表す、ISO 4217で定義されている通貨コードを設定します。※以下のコードは対象外です。 955, 956, 957, 958, 959, 960, 961, 962, 963, 964, 999 |
〇 | - | (null) | |
Tds2PreOrderDate | 半角数字8桁 固定
商品の発売予定日先行予約購入の場合は、商品の発売予定日を設定します。YYYYMMDD形式で設定してください。 |
〇 | - | (null) | |
Tds2PreOrderPurchaseInd |
商品の販売時期情報先行予約購入か、発売済み商品の購入かを設定します。01:発売済み商品 02:先行予約商品 |
〇 | - | (null) | |
Tds2ReorderItemsInd |
商品の注文情報カード会員が以前購入した商品を再び注文しているかどうかを設定します。01:初回注文 02:再注文 |
〇 | - | (null) |
結果パラメータ仕様
多通貨クレジットカード決済(DCC)を選択した場合に、加盟店様に返却する多通貨クレジットカード決済(DCC)固有の結果パラメータは以下の通りです。
dcc |
多通貨クレジットカード決済(DCC)固有部多通貨クレジットカード決済(DCC)固有の結果パラメータセットです。 |
|||||||
---|---|---|---|---|---|---|---|---|
Status |
取引状態取引の状態を示す以下の値が設定されます。CAPTURE:即時売上 UNPROSESSED:未決済(オーソリエラー等で決済が完了していない状態) |
|||||||
Method | 半角数字1桁 固定
支払方法"1"(一括)が設定されます。 |
|||||||
TranDate | 半角数字14桁 固定
決済日時与信を行った日時が設定されます。(yyyyMMddHHmmss形式) |
|||||||
DccAmount | 半角数字12桁
支払通貨決済額支払通貨換算後の金額が設定されます。(整数部10桁、小数部2桁) |
|||||||
DccFtn | 半角数字12桁
FX追跡番号(FTN)支払通貨換算に適用した為替レートに紐付くFTNが設定されます。 |
|||||||
DccCancelAmount | 半角数字7桁
減額金額の累積キャンセル時の金額が設定されます。 |
|||||||
DccCancelTax | 半角数字7桁
減額税送料の累積キャンセル時の税送料が設定されます。 |
|||||||
DccIncreaseAmount | 半角数字7桁
増額金額の累積増額時の金額が設定されます。 |
|||||||
DccIncreaseTax | 半角数字7桁
増額税送料の累積増額時の税送料が設定されます。 |
|||||||
registcard |
決済後カード登録固有部決済後カード登録固有の結果パラメータセットです。決済後カード登録時会員IDが指定され、かつお客様がクレジットカード情報の登録を許可した場合 多通貨クレジットカード決済(DCC)固有部と共に加盟店様に返却します |
|||||||
SiteID | 半角英数13桁
サイトIDカードを登録した会員に紐付くサイトIDが設定されます。 |
|||||||
MemberID | 半角英数記号60桁
会員ID指定した決済後カード登録時会員IDが設定されます。 |
|||||||
CardSeq | 半角数字4桁
カード登録連番登録したカードの論理連番が設定されます。 |
|||||||
CardNo | 半角数字16桁
カード番号登録したカード番号をマスクした値が設定されます。 |
|||||||
Result |
決済後カード登録処理結果決済後カード登録の処理結果(状態)が設定されます。
|